home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / extend.exe / EXTEND.DOC < prev    next >
Text File  |  1992-11-30  |  20KB  |  369 lines
  1. (*
  2.                                   EXTEND.PAS
  3.                                   Version 6
  4.                                November 30, 1992
  5.                               by Scott Bussinger
  6.                              Compuserve 72247,2671
  7.  
  8.  
  9.   MS-DOS and PC-DOS Turbo Pascal 3.0 and higher only allow up to 15 files to
  10. be open at the same time, due to limitations in DOS.  This file shows you how
  11. to have up to 96 files open simultaneously under DOS 2.0 or 2.1, or 252 files
  12. open simultaneously under DOS 3.0 or higher.  Below is a description of how to
  13. use this technique, followed by a technical explanation of the implementation,
  14. for those who are interested.  Note this documentation is liberally based on
  15. the original EXTEND.PAS documentation by Randy Forgaard, but has been renamed
  16. to EXTEND.DOC and modified by Scott Bussinger to reflect the changes to
  17. involved in versions 2 and 3.
  18.  
  19. TO USE THIS TECHNIQUE:
  20.  
  21.   You simply include the EXTEND unit in the USES statement in the source code
  22. of your main program.  You will have to either compile the EXTEND unit
  23. separately or use Turbo Pascal 4.0's project compiling features to Make or
  24. Build your program (which will compile the EXTEND unit automatically).  The
  25. EXTEND unit should be the first unit in your USES statement, following only
  26. the DOS unit (which is USEd by the EXTEND unit).  The unit automatically
  27. installs itself and will uninstall itself when your program ends or an error
  28. is detected.  See the demo program below for an example of using the EXTEND
  29. unit.
  30.  
  31.   The EXTEND.PAS file will need to be available available to be compiled if
  32. the Make or Build features are used to compile the program.  The EXTEND.ASM
  33. is the source code for the assembly language interrupt handler used when
  34. running under DOS 2.  The EXTEND.OBJ file is the assembled object code for
  35. EXTEND.ASM and was compiled using A86, a shareware compiler available on
  36. Compuserve and other bulletin boards.
  37.  
  38.   You must edit your CONFIG.SYS file (see the DOS manual for details), so
  39. that it includes a line that says "FILES=XXX".  XXX should be a number that is
  40. at least 3 greater than the maximum number of files that will be in use
  41. (opened by RESET, REWRITE or APPEND) at the same time during the execution of
  42. your program (larger values will provide no additional benefit, with respect
  43. to your individual program), and should not exceed 99 (for DOS 2.0/2.1) or 255
  44. (for DOS 3.0 and higher).  Under any version of DOS, the minimum allowable
  45. value for XXX is 8.  Then, reboot your computer so that the FILES=XXX
  46. parameter takes hold.  This same change to the CONFIG.SYS file will have to be
  47. made on any machine in which your program is to run.
  48.  
  49.   Running the sample program at the bottom of this file will tell you the
  50. maximum number of files you can have open at once (usually 3 less than the
  51. number of files specified in the CONFIG.SYS file as discussed above, unless a
  52. resident program has opened some files and hasn't closed them yet).
  53.  
  54.  
  55. THE TECHNICAL DETAILS:
  56.  
  57.   Much of the following information is not documented in the DOS Technical
  58. Reference manual.
  59.  
  60.   Under DOS 1.0 and 1.1, all files were accessed via File Control Blocks
  61. (FCB's).  There was no limit to the number of FCB's that a program could use,
  62. so there was no limit to the number of files open simultaneously.
  63.  
  64.   Under DOS 2.0 and higher, an alternate (and preferable) method of accessing
  65. files was introduced, using a 2-byte integer called a "handle" to refer to a
  66. file.  A "handle" file is described using a data structure called a Device
  67. Control Block (DCB).  However, DOS provides the storage space for all DCB's,
  68. rather than having the application program store the DCB's, so the number of
  69. available DCB's is limited to the amount of space that DOS has set aside for
  70. them.  The maximum number of files/devices that can be open simultaneously, on
  71. the whole computer, is the number of slots available in the DCB Table created
  72. by DOS.  The DCB's in the DCB Table are consecutively numbered, starting with
  73. 0.  DCB's 0, 1, and 2 are predefined by DOS to correspond to the AUX, CON, and
  74. PRN devices, respectively.  All remaining DCB's in the DCB Table are available
  75. for files or devices used by application programs.
  76.  
  77.   So that I/O redirection can be supported, the DCB numbers are not used
  78. directly when accessing files.  Instead, a file "handle" is used.  A "handle"
  79. is an index into a 20-byte array, called the Handle Table, located at offset
  80. 18H of the Program Segment Prefix (PSP) for a program (for a general
  81. discussion of the PSP, see the DOS Technical Reference manual).  Each element
  82. of the Handle Table is the DCB number of a file or device.  The value at index
  83. "handle" in the Handle Table is the DCB number of the file or device that
  84. implements that file handle.  Thus, if the value 8 is in the 6th byte of the
  85. Handle Table, the handle "6" refers to the file (or device) described by the
  86. DCB in slot 8 of the DCB Table.  If a handle is not currently being used, its
  87. entry in the Handle Table is FFH.  DOS predefines the first 5 handles to be
  88. primary input, primary output, error, auxiliary, and printer, so the first 5
  89. entries in the Handle Table are 1, 1, 1, 0, and 2, corresponding to the DCB
  90. numbers for the CON (1), AUX (0), and PRN (2) devices.  This leaves only 15
  91. available handles for opening files (or new devices).
  92.  
  93.   Every time a new handle file is opened, a new handle gets used.  Since there
  94. are only 20 slots available in the Handle Table for a program, DOS only allows
  95. a "process" to have a maximum of 20 file handles in use simultaneously (and the
  96. first 5 entries are predefined, as just noted, unless those handles get closed
  97. and reused).  Every new handle file requires a unique handle, so only 20
  98. files/devices can be open at the same time by a single process (unless FCB's
  99. are used).  (A "process" is any program spawned using the DOS EXEC function
  100. call.  A process can be invoked by COMMAND.COM, or by another program.)  There
  101. can be many more than 20 DCB's in the DCB Table, so the real limitation is in
  102. the size of the Handle Table in the PSP.
  103.  
  104.   The size of the DCB Table (i.e., the maximum number of files/devices that
  105. can be open simultaneously in the whole computer) is controlled by the
  106. FILES=XXX entry in the CONFIG.SYS file.  The minimum number of slots is 8.
  107. Under DOS 2.0/2.1, the maximum number is 99, and under DOS 3.0 and higher,
  108. the maximum is 255.  As previously mentioned, the first three of these DCB
  109. slots are occupied by the AUX, CON, and PRN devices.
  110.  
  111.   A single program can use all of the DCB's in the DCB Table (except for the 3
  112. reserved by DOS) all on its own, by effectively bypassing the Handle Table in
  113. the PSP, except on a temporary basis.  The program can accomplish this feat by
  114. using, say, only one entry in the Handle Table for all of its files.  Instead
  115. of allowing DOS to store the DCB numbers in the Handle Table, the program can
  116. store these numbers elsewhere.  Then, to manipulate a file using DOS, the
  117. program can temporarily put the DCB number of that file into a designated slot
  118. in the Handle Table, pass the index of that table slot (i.e., that "handle")
  119. to DOS, and DOS will operate on that handle/DCB number.  After the DOS call,
  120. the program can remove that DCB number from the designated Handle Table slot,
  121. freeing up that handle for use in another DOS call for another file.  In this
  122. way, DOS can be fooled into accessing up to 96 (or 252) different files/devices
  123. using a single handle entry in the Handle Table.
  124.  
  125.   To obtain the address of the Handle Table, which is at offset 18H in the
  126. PSP, the program needs to find the address of its PSP.  Under Turbo Pascal
  127. 4.0, the segment address of the PSP is stored in a pre-defined variable called
  128. PrefixSeg setup by Turbo's standard initialization code.  All of the
  129. manipulation of the DCB's and handles is dealt with by ExtendHandler which is
  130. an interrupt handler which intercepts all DOS functions calls (INT 21) and
  131. checks to see if the function involves a handle number.  If the function
  132. returns a handle (e.g. an Open File) it then return